Cryptocurrency Subscriptions 

Protocol Spec 



Basic Description 

First, the user signs up for the service on the merchant's website. At the end of the process, the 
merchant gives the user two bits of information: 

1. Payment callback - a url that returns the amount owed, as well as the payment address 

2. Schedule - a cron like syntax for how often to make a payment. 

The user then goes to their wallet application (that has the subscription payment protocol 
implemented), creates a new subscription, then adds those two bits of information. 

Example: 

Bob goes to magazine.com, adds a magazine subscription to his cart. At the end of the checkout 
process. Bob sees this: 

Thank you for your subscription! You now must configure your bitcoin wallet to send us 
payment at the start of each month, use the following settings: 

name: Supercool Magazine Subscription 

callback: https://magazone.com/payment?token=wifhvwgrj568tbku 
schedule: 0 01** 

Bob then goes into his wallet, clicks "create new subscription". He is then shown a form that 
looks like this: 

Create New subscription 

name: 

callback: 

schedule: 

[submit] 

Bob fills out the form with the info magazine.com gave him. Bob can then go to his 
"subscriptions" section of his wallet and see a list of all subscriptions currently active. 



max payment amount: (optional) 

end date: (optional) 

alert me before sending? [ ]yes [xjno 



Callback 

The callback is just a url that returns a JSON encoded response with information on how to make the 
payment. For instance, an example callback response may look like this: 

{"address": "lHWpyFJ7N6rvFkq3ZCMiFnqM6hviNFmG5X", "amount": 24000, 
"units": "bits", "currency": "BTC"} 

In the example above, there is a 'token' parameter in the url. This bit of information corresponds 
to the user who is making the payment. This parameter is optional, and not part of the protocol. 
The callback URL can be any valid URL. 

Schedule 

This value determines how often the wallet should send payment. The syntax for this section comes 
straight from the cron utility. In the example above, the value "0 0 1 * *" means "at midnight on the 
first of each month". 

The time at which the schedule value describes is when the payment is sent. From the merchant's 
perspective, the payment may be due at a later date. For instance, the magazine subscription defines the 
payment be sent on midnight on the first of each month, but in reality the merchant won't expect the 
pajmient until a few hours or days after that time. This to account for situations where the user has to 
respond to the authorize request (if there is one). Also, some users may have their computer's timezone 
set in such a way that the payment arrives a few hours later than expected. 

Canceling 

If the user wants to end the subscription, all they have to do is delete the subscription from their wallet 
application. Eventually the merchant will discover the customer is not paying any more and the 
customer's service will be canceled. The merchant can also cancel the subscription by making it so their 
callback always returns an amount of 0. 

Interface 

Each wallet application is responsible for making the user experience good. For instance, the wallet 
could send an email to the user asking to authorize the payment. Or the wallet could only send an 
authorize email if the amount is greater than a user-defined limit. 

Future Proof 

This protocol has bee developed specifically to never need to be changed. The protocol is designed to 
work for other cr5^tocurrencies as well. 



Making it easy for the user 

To make the data entry process easier, the merchant can construct a hnk element on their page that, 
when chcked by the user, automatically enters the data to the user's bitcoin wallet. For example: 

<a href= "paymentsubscription: https://magazonexom/payment?token=wifhvwgrj568tbku? 
schedule = 0,0,2, *. * " > Click here to subscribe !</a> 

Another way to make it easy is to encode the subscription into a QR code. The value to encode 
will look like this: 

payrnentsubscription: https://rnagazorie.corn/payment?token=wifhvwgrj568tbku? 
schedule =0,0, 2, *,* 

When you can this QR code, the wallet app will know that this is a subscription, and will handle 
setting it up automatically. 

Problems with this spec 

• The "paymentsubscription:" link syntax is not currently supported in any browser. This is a 
chicken and egg problem. 

• The cron syntax is hard to understand for normal people. Maybe it would be best to have the 
schedule value returned as part of the callback JSON? Also the uri syntax (link and QR code) 
has the schedule tacked on to the callback URL, which would potentially collide with a callback 
url that actually uses "schedule" as a parameter. 

• Not bitcoin specific. A lot of people in the bitcoin community hate altcoins. The fact that this 
protocol makes it easy to do subscriptions with other currencies may cause friction. 



